package com.nidu.demo.mail.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.mail.model.MailTemplate;
import com.nidu.demo.mail.model.MailTemplateCriteria;

import java.util.List;
import java.util.Set;

/**
 * 邮件模板网关接口
 * 供领域层调用，实现跨上下文/基础设施的邮件模板数据访问
 *
 * @author auto
 */
public interface MailTemplateGateway {

    /**
     * 创建邮件模板
     *
     * @param mailTemplate 邮件模板信息
     * @return 创建后的邮件模板
     */
    MailTemplate create(MailTemplate mailTemplate);

    /**
     * 修改邮件模板
     *
     * @param mailTemplate 邮件模板信息
     * @return 修改后的邮件模板
     */
    MailTemplate update(MailTemplate mailTemplate);

    /**
     * 删除单个邮件模板
     *
     * @param id 邮件模板ID
     */
    void deleteById(Long id);

    /**
     * 批量删除邮件模板
     *
     * @param ids 邮件模板ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 根据邮件模板ID查询
     *
     * @param id 邮件模板ID
     * @return 邮件模板信息
     */
    MailTemplate getById(Long id);

    /**
     * 根据邮件模板ID列表查询
     *
     * @param ids 邮件模板ID列表
     * @return 邮件模板列表
     */
    List<MailTemplate> getByIds(Set<Long> ids);

    /**
     * 根据模板编码查询
     *
     * @param code 模板编码
     * @return 邮件模板信息
     */
    MailTemplate getByCode(String code);

    /**
     * 列表查询
     *
     * @param criteria 查询条件
     * @return 邮件模板列表
     */
    List<MailTemplate> listByCondition(MailTemplateCriteria criteria);

    /**
     * 分页查询
     *
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<MailTemplate> pageByCondition(MailTemplateCriteria criteria);

    /**
     * 获取所有邮件模板
     *
     * @return 邮件模板列表
     */
    List<MailTemplate> listAll();

}
